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How to Use This Manual 


The Messenger™ electronic mail program allows PLAN File 
Server users to send messages to one or more of the users on 
the same or any connected network. This program features 
comprehensive English prompts and “Help” displays that make it 
easy to use. 


PLAN File Server software supports The Messenger electronic 
mail program under a number of microcomputer operating sys- 
tems (environments). Since this is the case, our documentation 
assumes that you have already read the manuals written by the 
manufacturer of your microcomputer explaining the use of your 
computer under the operating system that you intend to be 
using. In the body of this manual we describe how the mail sys- 
tem works. When it is necessary to provide specific instructions 
for particular environments, we do so in the appendix for that 
environment (found at the end of this manual). 


Since your network takes over communication with the file 
servers for you, you don't need to have knowledge of network 
file management to use this application. However, there are 
introductory manuals and guides that we would like all users to 
be familiar with in order to be comfortable while operating their 
workstation. If you have not already read these manuals, be 
aware that you can refer to them when you come across con- 
cepts or situations concerning the network that you are unfami- 
liar with. 


The recommended manuals are: 
PLAN SERIES General Information Manual 
PLAN File Server User's Manual 
PLAN File Server User's Guide for your environment 


A bibliography of PLAN Series manuals and guides appears at 
the end of this manual. 
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About This Manual: 


Chapter 1 is an introductory overview. It defines the different 
components of a message and describes the stages the mes- 
sage goes through between its creation by the sender and its 
final disposition by the recipient. The procedures the user fol- 
lows in order to send a message are also introduced here. 


Chapter 2 explains how the mail program is started up and pro- 
vides a breakdown of its different levels: the command level, the 
incomming level, and the outgoing level. 


Chapter 3 explains in detail how to send and receive mail. Each 
of the commands and options relevant to sending and receiving 
mail is explained in detail here. 


Chapter 4 explains how to file mail. Each of the options and 
commands relevant to filing mail is explained in detail here. Mail 
can also be printed on a shared printer (if your installation has 
the Print Server), or on a local printer through use of the “Write” 
command. This capability is also discussed in Chapter 4. 


Chapter 5 explains how to make use of filed mail. The "Forward- 
ing” capability of the mail system is explained here. Filed mail 
can be printed on a shared or local printer. This capability is 
introduced here and detailed in the appendices for the various 
environments. 


NOTE: Chapters 2-5 contain tables of commands and options. 
The table in Chapter 2 shows all commands and options and 
explains which level they are issued from and what they do. 
The tables in Chapters 4 and 5 include only those commands 
and options relevant to the topics for those chapters. 


Chapter 6 covers other commands which you can use when 
running this software. For instance, there are a number of 
"HELP" displays which provide on-line documentation for the 
user. 


Chapter 7 contains instructions for setting defaults which will 
cause the Mail program to run automatically when the system is 
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Started up and which will cause the mail program to automati- 
cally execute the function of the user's choice. 


Chapter 8 contains instructions intended for programmers who 
are using this software in combination with other programs. 
This chapter describes the Nestar CVAL convention, which 
makes chaining of programs possible in the Apple Pascal 
environments. 


Mail subsystem installers and system managers should read 
this User's Manual as well as the Messenger Installation and 
Operations Manual. 


The material in this document applies to Version 2.5 of the 
Messenger software. 


We welcome criticisms and suggestions. Forms for reporting 
program and documentation errors or inadequacies are provided 
at the back of this manual. 


Contents 


‘Disclaimer ii 

How to Use This Manual iii 
Contents vii 

Chapter 1 Introduction 


1.0 What is a Message? 1-1 

1.1 The Progress of a Message 1-2 

1.2 The Storage of a Message 1-3 

1.3 Using the Messenger: An Example 1-3 


Chapter 2 Using the Messenger 


2.0 Getting Started 2-1 

2.1 Automatic Startup and Read 2-1 

2.2 What Happens when the Messenger Software is 
Started Manually 2-2 

2.3 The Messenger's Three Levels 2-2 

2.4 General Rules 2-8 


Chapter 3 Sending and Receiving Mail 


3.0 The READ Command 3-1 

3.1 The Incoming Mail Menu 3-2 

3.2 The K(eep) Menu Item 3-5 

3.3 Reading Registered (Return Receipt) Mail 3-6 
3.4 The CHECK Command 3-7 

3.5 The SEND Command 3-7 

3.6 The Outgoing Mail Menu 3-9 

3.7 The S(end) Menu Item 3-11 

3.8 Using Text Files 3-12 


Chapter 4 Filing Mail 


4.0 Filing Commands 4-1 
4.1 The F(ile) Menu Item 4-2 


vii 


CONTENTS 


4.2 The CLASSIFY Command 4-3 

4.3 Specifying Messages in the Mail File 4-5 
4.4 The DECLASSIFY Command 4-8 

4.5 The RENAME Command 4-9 

4.6 The SHOW CLASSES Command 4-10 
4.7 The DELETE Command 4-11 

4.8 The UNDELETE Command 4-12 


Chapter 5 Using Filed Mail 


5.0 The DISPLAY Command 5-1 

5.1 The HEADERS Command 5-2 

5.2 The ANSWER Command 5-3 

5.3 Header Line Suggestions Supplied by ANSWER 5-5 
5.4 The FORWARD Command 5-5 

5.5 The FORWARD Header 5-6 

5.6 Header Line Suggestions for FORWARD 5-7 

5.7 The RESEND Command 5-8 

5.8 The WRITE Command 5-9 

5.9 The PRINT Command 5-10 


Chapter 6 Other Commands 


6.0 Other Commands 6-1 

6.1 The CLEAR Command 6-1 

6.2 The HELP Command 6-1 

6.3 The “?” Command 6-2 

6.4 The NEWS Command 6-2 

6.5 The INFO Command 6-2 

6.6 The NET Command 6-3 

6.7 The SHOW Command 6-3 

6.8 The QUIT Command or Menu Item 6-4 


Chapter 7 Tailoring Your System 
7.0 Automatic Startup 7-1 
7.1 Startcmd File 7-1 


7.2 Defaults File 7-1 
7.3 Access, Usage, and Protection 7-3 


viii 


CONTENTS 


Chapter 8 The Nestar CVAL Convention for 
Apple Pascal 


8.0 Introduction 8-1 

8.1 CVAL 8-1 

8.2 Format of CVAL String 8-2 
8.3 Complex Chain Sequences 8-2 


Appendix A Using the Messenger Program in the 
Apple // Pascal Environment 


A.O Introduction A-1 

A.1 Invoking the Mail Program A-1 

A.2 Invoking the Mail Program Automatically upon Startup 
of Your Workstation A-2 

A.3 Proper Syntax for File Names when Storing and Using 
Text Files A-3 

A.4 Printing Messages on a Local Printer A-4 

A.5 Freezing the Screen Display A-5 

A.6 Breaking/Aborting Operations A-5 


Appendix B Using the Messenger Program in the 
Apple /// SOS Environment 


B.Q Introduction B-1 

B.1 Invoking the Mail Program B-1 

B.2 Invoking the Mail Program Automatically upon Startup 
of Your Workstation B-2 

B.3 Proper Syntax for File Names when Storing and Using 
Text Files B-3 

B.4 Printing Messages on a Local Printer B-4 

B.5 Freezing the Screen Display B-5 

B.6 Breaking/Aborting Operations B-5 


Appendix C Using the Messenger Program in the 
IBM PC UCSD p-System Environment 


C.0 Introduction C-1 

C.1 Invoking the Mail Program C-1 

C.2 Invoking the Mail Program Automatically upon Startup 
of Your Workstation C-2 


CONTENTS 


C.3 Proper Syntax for File Names when Storing and Using 
Text Files from Messenger C-3 

C.4 Printing Messages on a Local Printer C-4 

C.5 Freezing the Screen Display C-5 

C.6 Breaking/Aborting Operations C-5 


Appendix D Using the Messenger Program in the 
IBM PC DOS Environment 


D.0 Introduction D-1 

D.1 Invoking the Mail Program D-1 

D.2 Invoking the Mail Program Automatically upon Startup 
of Your Workstation D-2 

D.3 Printing Messages on a Local Printer D-3 

D.4 Freezing the Screen Display D-4 

D.5 Breaking/Aborting Operations D-4 


Index IN-1 
Bibliography BB-1 


Reader Comment Form back page 


Chapter 1 


introduction 


1.0 What is a Message? 


In the Messenger System, a message is simply a sequence of 
text lines. For example: 


TO: Jones 

FROM: Smith 

DATE: Thu 19-Feb-1984 11:33:10 
SUBJECT: Tomorrow's meeting 


Please be sure to have the final audit report 
with you so that you can answer any specific 
questions that come up. 


Note that the message contains two parts: the “header” and the 
"body". The header contains special lines that identify the 
sender, receiver, date, and subject of the message. The body, 
which is separated from the header by a blank line, consists of 
any number of lines of text. 


When a message is composed and sent, some of the header 
lines are supplied automatically by the Messenger, while others 
are supplied by the sender. All the header lines are displayed 
when the message is received. Some common header lines 
are: 


TO: Who is to be a primary recipient of the 
mail (always present) 
CC: Who else is to receive a copy (optional) 


FROM: Who sent the message (always present-- 
automatically generated 

DATE: When the message was sent (always present-- 
automatically generated) 


1-1 


INTRODUCTION 


SUBJECT: A short description of the contents 
(optional) 
IN-REPLY-TO: A reference to a previous message 
automatically generated for replies) o~ 


The header lines TO, FROM, and DATE are present in all mes- 
sages. 


1.1 The Progress of a Message 


Messages can go through several stages between their creation 
by a sender and their final disposition by a recipient. The three 
fundamental stages are: 


(1) The message is composed. For short messages, the 
sender may simply type in the text at the keyboard. Previ- 
ously prepared text can be included at any point. 


(2) The message is sent to one or more recipients. These can a 
be primary recipients (those on the TO list), or people 
receiving copies (those on the CC list). The sender may, if 
desired, retain a copy of the message. The recipients, of 
course, need not be using the Messenger at the time the 
message is sent; mail will be held awaiting delivery for as 
long as necessary. 


(3) The message is received. Delivery of a message is com- 
pleted when a recipient asks to read his incoming mail. 
After a message is read, it can be discarded or saved for 
future reference at the reader's discretion. If a reply is 
appropriate, a message can be sent back to the originator. 


These are the basic stages in the life of a simple message. 

More complex operations are possible, such as forwarding mail 

to others, or requesting return receipts when mail is read. but io 
these are just elaborations of the simple scheme. 
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1.2 The Storage of a Message 


‘Messages reside in one of three places: 


(1) At the user station, as an "active" message that is 
currently being composed or read. 


(2) On disk, stored and awaiting delivery. Every user of the 
mail system has a queue of incoming messages that have 
not yet been read; this is the "new mail" queue, which may 
be thought of as an electronic In-basket. 


(3) On disk, filed away for future reference by the sender or 
the recipient, or both. Every user of the mail system has 
an area.on the disk for saving copies of mail sent to others 
and mail received; this is the “mail file", which may be 
thought of as an electronic filing cabinet. 


In addition, messages can be printed locally (on a printer 
attached directly to the user's workstation), or on a shared 
printer, and can be transferred to and from textfiles. The appen- 
dix for your particular environment discusses this. 


The “mail file" can be thought of as a repository of messages 
that have been sent or received. New pieces of mail may be 
entered into this repository at any time and may be cross- 
indexed in categories (called classes) that the user invents. 
These classes can then be used to manage groups of mes- 
sages. 


1.3 Using the Messenger: An Example 


Using the Messenger is extremely simple and does not require 
extensive training or a knowledge of programming. The following 
example demonstrates two basic operations: 


(1) Reading an incoming message. 
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(2) Composing and sending an answer to that message. 


In the example that follows, the user's input is underlined; every- 
thing else is typed automatically by the Messenger. <Return> 
indicates that the return key has been pressed. 


NOTE: The following is an example. You do not need to be run- 
ning the mail software at this point. However, in later chapters, 
you will. This manual assumes that a system manager has 
already taken the necessary steps to configure the mail system 
software to be ready to support the user. If this has not been 
done, the user's station will not be prepared to send or receive 
mail. The PLAN File Server Messenger Installation and Opera- 
tion Manual contains all the instructions for configuring the 
software to support new users. 


When the Messenger becomes active, it displays a banner fol- 
lowed by: 


Today is Thu 19-Feb-1984 13:33:13 
For help type ? RETURN to any request 
Command? READ <Return> 


(With the READ command the user asks to read any mail 
currently in the new mail queue - his In-basket.] 


You have 1 message: 
02/19 12:54 SMITH 
Read 02/19 12:54 SMITH (Y/N)? Y <Return> 


[Only one new message has arrived since this user last read his 
mail. The timestamp and name in the label are used by the sys- 
tem to identify the message. By replying "Y" to the Messenger's 
prompt the user has asked to read the message. ] 


To: JONES 

From: SMITH 

Date: Thu 19-Feb-1984 12:54:14 
Subject: Tomorrow's meeting 
Display it (Y/N)? Y <:Return> 


[The header of the message has been displayed, and the user, 
Jones, can decide whether or not to look at the message itself. 
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Since Jones has replied "Y", the Messenger displays the body 
of the message.] 


Please be sure to have the final audit report 
with you so that you can answer any specific 
questions that come up. 


IN:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? A <Return> 


[The body of the message has been listed, followed by a menu 
of actions appropriate for incoming messages (the “Incoming” 
menu, appearing here as it does on a 40 column screen). After 
reading the message, Jones has decided to send back an 
answer, and so has typed "A".] 


To: SMITH? <Return:> 
CC: ? <Return> 
Subject: Re: Tomorrow's meeting ? <Return> 


Enter message or %filename, terminate with 
<Esc> < Return> 


{The mail system automatically suggests values for the header 
fields, and by pressing the return key, JONES indicates that the 
suggestions are acceptable. He now enters his reply to Smith.] 


I'm expecting the audit report to be delivered 

this afternoon at 4; if it gets here on time I'll be 

able to bring it to the meeting. If not, we may 

have to stall them another day or so. <Esc> <Return> 


[In order to signal the end of the message, JONES types an 
<Esc> followed by a <:Return>>. While he is typing the mes- 
sage, JONES can correct errors by using the appropriate delete 
keys (these vary according to personal computer type). How- 
ever, he can only correct errors within the same line. Once he 
has typed a «Return> at the end of a line, he can not return to 
the text in that line and correct it.] 
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OUT:D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) W(rite)? S <Return:> 


[Another option list, appropriate for outgoing messages, is 


displayed after the reply has been composed (the “Outgoing” 


menu). Jones chooses “S” in order to send his reply.] 
~ Smith: Writing....... Sent. 


OUT:D(isplay) F(ile) P(rint) Q(uit) 
R(eceipt) S(end) Write)? Q <Return> 


[The reply has been sent and is now in Smith’s new mail queue, 
and he will get it when he next reads his mail. Since Jones 
doesn't want to do anything more with the reply he has just sent 
(such as saving a copy for himself), he answers "Q" for quit 
and returns to reading the mail.] 


IN:A(nswer) D(isplay) F(ile) FO(rward) K(eep) 
N(ext) P(rint) Q(uit) W(rite)? Q <Return> 


[The Messenger has returned to the menu that asks Jones what 
he wants to do with the incoming message. Since he doesn't 
want to do anything more with it (like forwarding it to someone 
else), he again reponds with "Q".] 


Command? 
[The mail system is now waiting for more commands. Jones 
has received a message, read it, and composed and sent a 
response. | 
There are many other commands and features of the 


Messenger. They will be described in the following sections, but 
they all follow the simple menu style of this example. 
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Using the Messenger 


2.0 Getting Started 


There are two ways to invoke the mail program. You can run 
the program, as explained in the appendix for your environment, 
or the Startcmd file on your boot or work volume can be edited 
to start the mail program automatically when you power up your 
system. Your system manager will help you with this procedure, 
which is explained in Chapter 7 of this manual. 


2.1 Automatic Startup and Read 


In addition to configuring your startup file so that your mail sys- 
tem will run when your workstation is powered up, you can con- 
figure a file containing default values to perform some other 
automatic functions for you. (See the workstation environment 
appendices for more details.) 


Here is an example of what it does automatically. A banner is 
displayed, followed by: 


Today is Thu 19-JAN-1983 13:33:13 
For help type ? RETURN to any request 


Command? READ <Return> 


A greeting appears and the Messenger looks for new mail for 
the station's user as soon as the system is turned on. Chapter 
7 of this manual explains how to tailor these automatic defaults 
to your specific needs. 


2-1 


MESSENGER 


2.2 What Happens when the Messenger Software is 
Started Manually 


If you do not choose to have your mail program invoked 
automatically each time you power up, such instructions can be 
left out of your boot or work volume’s Startcmd file. When you 
have manually invoked the mail software as explained in the 
appendix for your environment (and if your defaults file contains 
no relevant defaults), you will see the mail program's banner 
and the following prompt: 


Who are You? 
The user will respond with the identification assigned to him by 
the system manager (last name or initials, for example), and the 
Messenger will ask 

Command? 
The mail program is now operational. 
NOTE: If, when you execute the Messenger, all drives have 
volumes mounted, the program will display the volumes 
mounted and ask 

“Available drive number?" 
You should respond with the number of a drive that the program 
can use. The volume currently mounted on it will be unmounted 
(and not remounted when you leave the Messenger). 
For the program to work correctly, you must specify a drive 
number that is available for use with virtual volumes in your 
workstation environment. 
2.3 The Messenger’s Three Levels 
The Messenger's commands and menu items can be divided. 


into four categories and can be entered at three different levels 
(See Table 1, page 2-6): 
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(1) the “Command” Level (C Level) 
(2) the "Incoming Mail" Level (I Level) 
(3) the “Outgoing Mail” Level (O Level) 


Levels | and O each present the user with a menu of further 
actions after a message has been read or composed. For 
instance, if a user types READ at the outermost (Command) 
level of the Messenger, and reads a new message, the Incom- 
ing Mail menu of further options is then presented, so that the 
message can be filed, answered, printed out, or otherwise mani- 
pulated by the user. These actions occur at the Incoming Mail 
Level, and the menu options presented there are for that mes- 
sage alone. 


Table 1 lists the commands and menu items available at each 
level. The command "READ" moves the user from Level C to 
Level |. The commands "SEND", "ANSWER", and "FORWARD" 
move the user from Levels C or | to Level O. 


Level C prompts for a command with 
Command? 


On Levels | and O, available commands are displayed in menu 
form. The Level | Incoming menu appears as 


IN:A(nswer) D(isplay) F(ile) FO(rward) 
K(eep) N(ext) P(rint) Q(uit) W(rite)? 


The Incoming and Outgoing menus are for use only with the 
current message being read, answered, or forwarded, or to ask 
for the next piece of new mail. Typing Q<Return> returns the 
user to the previous level. 


When Level C (the Command Level) is displayed no activity is 
pending. The Messenger displays the "Command ?" prompt 
because it is waiting for the user to initiate an activity by enter- 
ing a command. 


Suppose that the user first asks to read new mail (READ) and 
finds five messages waiting in a queue for him. He reads the 
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first message (at level !) and decides to ANSWER it. He com- 
poses and SENDs his reply at Level O, FILEs a copy away, but 
then decides to delete some mail previously filed and rearrange 
the remaining filed messages before continuing to read his new 
mail. The DELETE command is a first level command. The 
user must type Q ~«Return> twice, returning to Level C through 
the Incoming READ level, before entering DELETE. 


Figure 1 
o 
M 

Figure 2 
o 
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Table 1 (Part 1) 


Level 


Sending and Receiving 


READ 
N(ext) 


K(eep) 
CHECK 
SEND 
S(end) 


R(eceipt) 


Filing 
F(ile) 
CLASSIFY 
DECLASSIFY 
RENAME 
SHOW 
CLASSES 
DELETE 


UNDELETE 


C = Command List 


4.8 


tion Description or Menu Item 


Read new mail 

Read the next piece 
of mail 

Save new mail 
without reading 

Wait for new mail 

Send mail 

Transmit a newly 
composed message 

Request a receipt 
before mail delivery 


File new mail 

Classify messages in 
one or more classes 
in mail file 

Remove message from 
classes in mail file 

Change the name of a 
mail-file class 


Display the current classes 


Delete messages from 
mail file 

Recover messages 
accidentally deleted 


| = Incoming Mail O = Outgoing Mail 


Using Filed Mail 
DISPLAY, 

D(isplay) 
HEADERS 
ANSWER, 

A(nswer) 
FORWARD, 

F(orward) 
RESEND 
WRITE, 


W(rite) 


PRINT, C 


P(rint) 


Other 


CLEAR 
HELP 


C 

C 
“2” C 
NEWS C 
INFO C 
NET C 
SHOW C 
Q(UIT) 


C = Command Level 


Cl, 
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Table 1 (Part 2) 


Command Level Section Description or Menu Item 
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O 68 


Display filed mail 
Display current message 
Display only the headers 
of filed mail 
Answer a filed message 
Answer current message 
Forward a filed message 
Forward current message 
Send a filed message 
Write a filed message to a 
text file or local printer 
Write current message 
to a text file or local 
printer 
Print a filed message 
on system printer 
Print current message 
on system printer 


Clear the screen 

Display a command 
summary 

Prompt for next action 

Display news about the 
system 

Displays local information 

Issue Network File 
Server commands 

Display miscellaneous 
information 

Return to previous level 


| = Incoming Mail O = Outgoing Mail 
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2.4 General Rules 


There are certain general rules that apply to all communication 
with the Messenger: 


(1) 
(2) 


(3) 


(4) 


(5) 


(6) 


(7) 


All input can be in upper or lower case. 


All input (with two exceptions noted later) is terminated by 
pressing the <Return> key. Before the return key has 
been pressed, errors may be corrected and replacements 
typed using the left arrow, backspace, or delete key, 
depending upon the configuration of the workstation. 


To leave the current level in the Messenger press Q 
<Return>. Q <Return> is equivalent to a command to 
"return to what was being done before”. 


if the user is unsure about how to respond to any prompt, 
typing ? <Return> causes a reminder to be displayed. 
The reminder describes what the Messenger expects next 
from the user. (Further information is available with the 
HELP command.) 


if any part of a command is left out, the Messenger will 
ask for it. Thus, if a user can’t remember what information 
should be supplied with a particular command, typing in 
the command name alone will produce a prompt. 


Prompts that end in “(YN) ?” require a yes/no response; 
type either “Y" or “N” (or “y” or “n"), followed by 
<Return>. 


To discontinue any activity, type <Esc>-<:Return>. If a 
menu is being displayed, this action will return the user to 
the previous level. If a menu item has been selected and 
input is being prompted for, this action will return the user 
to the menu. 


A 


MESSENGER 


(8) At the Command level, commands may be abbreviated by 
the first three or more letters (REA for READ, for exam- 
ple). However, all letters typed must be in the correct 
order. For example, DELETE can be abbreviated DELE, 
but not DELI. 


(9) To stop a display from scrolling off the top of the screen, 
or to abort a display or other operation in progress, and go 
on to something else, type the key or key sequences 
described in the appendix for your environment. 


These general rules apply to all input to the Messenger. 
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Sending and Receiving Mail 


mman Level ion Description or Menu Item 
READ C 3.0 Read new mail 
N(ext) | 3.1 Read the next piece 
of mail 
K(eep) | 3.1 Save new mail 
without reading 
CHECK C 3.4 Wait for new mail 
SEND C 3.5 Send mail 
S(end) O 3.6 Transmit a newly 
composed message 
R(eceipt) O 3.3 Request a receipt 


before mail delivery 
C = Command List | = Incoming Mail O = Outgoing Mail 


3.0 The READ Command 


The READ command is entered at the Command level and is 
used to ask the Messenger to look for incoming messages in 
the new mail queue. The Messenger will respond to READ with 


You have no new mail 
or with the identification names of any new messages: 
You have 3 messages: 
02/19 14:24 SMITH 
02/19 14:30 JONES 
02/19 15:03 BROWN 
Read 02/19 14:24 SMITH (Y/N)? 


The Messenger asks whether new mail should be displayed, list- 
ing the messages one at a time. 


3-1 


SENDING AND RECEIVING 


The messages are presented in chronological order (the order in 
which they were generated). If more than one network segment 
is present, this order may not be absolutely chronological. The 
message identification includes the month, day, hour and minute 
at which the messages were created, and sender identification. 


Pressing “N” <Return>, will cause the Messenger to go on to 
the next message. Messages that are not read will remain in the 
new mail queue for next time. 


Responding with "Y" <Return> will cause the message to be 
read from the new mail queue. The header of the message will 
be displayed, and the Messenger will ask whether or not to 
display the body of the message: 


TO: JONES,BROWN 

FROM: SMITH 

DATE: Thu 19-JAN-1983 14:24:29 

SUBJECT: Upcoming Audit 

IN-REPLY-TO: Message of Thu 19-JAN-1983 13:46:15 
Display it (Y/N)?Y 


This message was sent by Smith to Jones and Brown on 
February 19, in response to a previous message sent the 
same day. The Messenger asks whether to display the 
body of the message. Smith types in “Y” and the message 
appears. 
The 1982 information is ready for your use. 
Next, whether the body of the message has been displayed or 
not, a menu of choices is presented called the “Incoming” menu. 
This menu is used to determine the disposition of the message. 


3.1 The Incoming Mail Menu 


After a message has been READ, a menu of options is 
displayed 


IN:A(nswer) D(isplay) F(ile) FO(rward) K(eep) N(ext) 
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P(rint) Q(uit) W(rite)? 


To choose a menu item, type the capitalized letters (not those in 
parentheses), followed by <Return>. Q(uit) returns the user to 
the Messenger Command level. A(nswer) and FO(rward) move 
the user to the Outgoing Menu (the Messenger Level O). 


A(nswer) -- temporarily suspends examination of new mail, 
and allows the user to compose and send a reply. See 
the ANSWER command (Section 5.2) for an explana- 
tion of the A(nswer) prompts. When the A(nswer) pro- 

` cess is finished, the Incoming Mail (Level |) menu will 
be.u redisplayed so that further action can be taken on 
the same incoming message. 


D(isplay) — displays the message again (header and body) 
and then repeats the Incoming menu. 


F(ile) - saves a copy of the message in the user's mail file. 
The Messenger asks whether to file the message in 
one or more particular classes; respond with one or 
more class names (separated by commas), or with 
<Return>, to file the message without classifying it. 


Class? MEETINGS <Return> 
Filed message number 37 


When the message has been filed, the Messenger returns to the 
new mail (Incoming) menu. Filing and classifying mail is dis- 
cussed in detail in Chapter 4. 


FO(rward) — forwards this message to someone else. This 
command temporarily suspends examination of incoming 
mail, and allows the reader to send a copy of this mes- 
sage to one or more people, preceded by an optional pre- 
face that the reader composes. See the FORWARD com- 
mand (Section 5.4) for an explanation of the FO(rward) 
prompts. After the message has been forwarded, the new 
mail menu will be redisplayed for other action on the 
same incoming message. 
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K(eep) — keeps the message in the new mail queue. Incoming 
mail that has been read (whether or not the body was 
displayed) is normally removed from the new mail queue. 
To keep the message in the queue, choose the K(eep) 
option of the menu and the message will be presented 
again the next time the READ command is used. 


N(ext) — goes on to the next message. Use this menu option 
after the current message has been processed. The 
current message will be discarded from the new mail 
queue unless the K(eep) option was selected first. 


P(rint) — For networks with a print server, the Print menu item 
will cause the current message to be printed out. 


Q(uit) — stops reading incoming mail. The current message is 
deleted from the new mail queue unless K(eep) was 
selected before Q(uit). The user returns to the command 
line after typing "Q", all subsequent messages in the 
queue remain until next time the READ command is 
used. 


Write) — writes the incoming message to a text file or local 
printer. The Messenger will ask for the name of a text 
file to create and write the message to. The header and 
body are written in the same format as is displayed on 
the screen. Using such text files is discussed in Section 
3.5. When the message has been written, the new mail 
menu will be redisplayed. Anything already in the text file 
is erased. 


If the file is to be written to a local printer, the user must 
have a printer connected directly to the workstation and 
the printer must be supported by the operating system. 
The appendix for your environment contains information 
about printing from a printer that is connected directly to 
your workstaton. 


NOTE: <Esc><Return> — Exiting from the new mail menu by 


using the escape key causes the current message (and all sub- 
sequent messages) to be left in the new mail queue, and the 
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user to be returned to the command level. 


The Incoming mail menu will be displayed until the user selects 
Q(uit), A(nswer), FO(rward), or N(ext) and is moved to another 
level. At the end of the new mail queue, the Messenger will 
display 


End of new mail. 


and return to the command level. If new mail arrives after the 
READ command is given, the Messenger will display 


New Mail has arrived 


and list the new messages. 


3.2 The K(eep) Menu Item 
This is an incoming menu item. If a user responds to the prompt 


You have 1 message: 
07/13 11:00 SMITH 
Read 07/13 11:00 SMITH (Y/N)? 


with “N” <Return>, the piece of mail will be kept in the new 
mail queue. A “Y” reply will cause the header of the message 
to be displayed, together with a second prompt: 


TO: Jones 

CC: Brown 

FROM: Smith 

DATE: Mon 13-Jan-1983 11:00:46 

SUBJECT: Missing Audits 

IN-REPLY-TO: Message of Mon 13-Jan-1983 10:58:16 
Display it (Y/N)? 


Typing “Y” displays the body of the message. Typing “N” 
displays the Incoming menu. Then, pressing “K” <Return> for 
K(eep) will cause the Messenger to keep the message in the 
new mail queue, just as if the header had never been displayed. 


3-5 


SENDING AND RECEIVING 


The Incoming menu will then be redisplayed. 


3.3 Reading Registered (Return Receipt) Mail 


The sender of a message can request that “return receipts” be 
sent when the message is read by each of the recipients. A 
return receipt is a small message that documents the date and 
time that the original message was accepted. Registered mail 
can also be refused, in which case the return receipt indicates 
refusal, and the recipient is not shown the original message. 


When a registered message is delivered, the header is 
displayed and the recipient is asked, 


OK to send return receipt (Y/N) ? 


Answering “Y” causes a return receipt to be sent to the origina- 
tor and the recipient may proceed to display the message. An 
“N” causes the Messenger to ask 


Reject this mail (Y/N) ? 


If “Y”, a rejection message is sent to the originator indicating 
that the recipient has chosen not to read the mail. The 
Messenger then continues with the next message in the new 
mail queue. 


“N” to both questions (neither accepting nor rejecting the mes- 
sage) causes the message to be left in the new mail queue and 
the same questions will be asked the next time the READ com- 
mand is used. 


To send a registered message, press “R” for Receipt when the 
Outgoing Mail menu is displayed, after the message has been 
composed but before it has been sent. The Messenger will 
respond with 


A return receipt will be requested. 
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3.4 The CHECK Command 


The CHECK command is very much like the READ command in 
that it looks at the new mail queue and allows incoming mes- 
sages to be read. It differs from the READ command in the fol- 
lowing ways: 


(1) If the new mail queue is empty, CHECK displays: 


Waiting for new mail. Press space to 
enter commands. 


and the time. The Messenger then waits for new mes- 
sages to be received. When a message arrives, the com- 
puter bell rings and the Messenger displays the message 
identification just as if the READ command had been 
used. 


(2) After all the new mail has been read, the Messenger 
returns to wait for more new mail, instead of going to the 
command level. 


To return to the command level from Check mode, type a 
space. The prompt 


Command? 


will appear. 


3.5 The SEND Command 


The SEND command is used to compose and send messages. 
To use it, type SEND <Return> at the outer level, as in 


Command? SEND <Return> 


The Messenger will first ask a series of questions to obtain the 
information to be displayed in the header of the message, and 
then wilt ask for the text that will form the body of the message. 
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(3) 


(4) 


(5) 


Who is to receive the message: To? 


Respond with the identification of the direct recipients of 
the message. If there are more than one, separate them 
with commas. The identifications depend upon how the 
Messenger is installed by the System Manager; they are 
often the last names or the initials of the users. 


To? SMITHE, JONES 


if an incorrect identifier is typed in response to the prompt 
To?, the Messenger will later display 


SMITHE: No such user 


when the S(end) option is used. In this example, Jones 
has entered Smith’s name incorrectly in response to the 
To:? prompt. 


Who is to receive copies of the message: CC? 


Respond with the identification of people who are to 
receive copies of the message. The same rules as for 
specifying people on the "TO" list apply here. The 
Messenger makes no distinction between people on the 
"TO" list and those on the "CC" list. The only difference is 
in the interpretation applied by the recipients; in some 
organizations the protocol may be that those on the TO list 
are expected to reply or take specific action, but those on 
the CC list are being sent copies for their information only. 


Note: To have no one on the CC list, press <Return> in 
response to the prompt. 


What is the subject: Subject? 


Respond with a short description (on a single line) of the 
message. To supply no subject, press <Return:>. 


AN 
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All the information necessary for the header has now been 
given. The date, time, and sender's identification are supplied 
_automatically. The Messenger next asks for the body of the 
message: 


Enter message or %filename; terminate with 
<Esc><Return> 


Type in the text of the message. (Header and body entries can 
include text copied from text files; file names to be copied are 
preceded by "%". A discussion of this subject is found in Section 
3.8, "Using Text Files".) Terminate each line with <Return>. 
The message can be up to 3800 characters or bytes in length 
(about 760 words). 


When the body of the message has been completed, type 
<Esc>, either on a line by itself or at the end of the last line of 
the message. 


The message is now completely assembled, and the Messenger 
presents a menu of choices, called the “outgoing mail menu", 
which can be used to determine what is to be done with it. 


3.6 The Outgoing Mail Menu 
Out: D(isplay) F(ile) P(rint) Q(uit) R(eceipt) S(end) W(rite)? 
To choose a menu item (as with all menus presented by the 
Messenger), type the capitalized part of the name and press 
<Return>. For example, to D(isplay) the message, type 
"D<Return>". 
D(isplay) -- displays the entire message that has been 


composed. Both the header and the body are 
displayed. 
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F(ile) -- saves a copy of the message in the sender's mail 


file. The Messenger will ask for an optional list of 
Classes; respond with one or more class names 
separated by commas, or with <Return> to file a 
copy without assigning a class. 


Classes? <Return> 


Filed message number 38 


The outgoing mail menu will be redisplayed for further action. 
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Q(uit) -- stops the processing of this outgoing message. All 


action that you have previously specified will take 
place, but nothing else. If you have not F(iled), S(ent), 
P(rinted), or W(ritten) a copy of the message, you will 
be reminded that upon exiting, the message will be 
lost: 


OK to discard message (Y/N)? 


P(rint) -- causes the current message to be printed out (for 


networks with the Print Server subsystem option). 
Printed format is the same as screen display format. 


R(eceipt) -- requests that a “return receipt" be sent to you 


when the message is read by each recipient. The 
return receipt is a message that indicates whether the 
message was refused or accepted, and at what time. 
This option, if it is used, must be specified before 
S(end). Receiving “registered” mail is described in Sec- 
tion 3.3. 


S(end) -- sends the message to all people in the TO and 


CC lists of the message. As the message is sent to 
each person, the identification is displayed. If the mes- 
sage is being sent to a long list of people, the user 
abort key (described in the environment appendices) 
will stop the transmissions, but any copies already sent 
cannot be rescinded. 
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Wirite)-- writes a copy of the outgoing message to a text 
file or local printer. The Messenger will ask for the 
name of a text file to create and write the message to. 
After the message has been written, the outgoing mail 
menu will be redisplayed. If the text file already exists, 
you will be asked for permission to overwrite it. 


If the file is to be written to a local printer, the user sta- 
tion must have a local printer connected and the printer 
must be supported by the operating system under 
which the Messenger is being run. See Appendices for 
details. 


<Esc> <Return> -- exits the outgoing menus, just as typ- 
ing Q(uit) does. If you have not F(iled), S(ent), 
P(rinted), or W(ritten) a copy of the message, you will 
be reminded that upon exiting the message will be lost: 


OK to discard message 
(Y/N)? 


The outgoing mail menu will continue to be displayed until the 
Q(uit) option or <Esc> <Return> are used to return to the 
Command or Incoming Mail level. 


3.7 The S(end) Menu item 


The S(end) outgoing menu item is executed by pressing “S” 
<Return> when the Outgoing menu is presented. S(end) 
causes the Messenger to deliver the message that has just 
been composed. 


If Send is not used, the newly composed message will not be 
sent. Note that by composing but not sending messages, the 
user can use the Messenger to write notes or messages to be 
filed (using the File menu item) in one’s own mail file under 
some convenient class name. 


To compose a message and send it at a later date, use the 
RESEND command (Section 5.7). 
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Having composed and sent a message using S(end), the user 
will often want to compose and send another. To do so, press 
Q(uit) to return to the Command level, and type SEND again to 
repeat the process. Typing S(end) again without returning to 
the Command level will cause the Messenger to display 


Already sent. Send again? (Y/N)? 


for each recipient in the TO: list. This is to remind the user that 
in order to compose a new message, “SEND” must be typed in 
at the Command level. 


3.8 Using Text Files 


Text files can be included in message headers (except for sub- 
ject: field) and bodies by specifying the filename, preceded by 
“%", in response to the Messenger's prompts. 


For example, the prompt and response 
To? %STAFF 


will cause the Messenger to send the message being composed 
to the mailing list found in the file STAFF. This option is espe- 
cially useful when messages are frequently sent to a long list of 
recipients. Recipients should be listed in the file just as they 
would be in the To: and CC: headers. (For readibility, carriage 
returns may be used between names in the file.) Names that 
are not part of the file may be included either before or after 
specifying the file. For example, 


To? %TECHSTAFF. JONES, SMITHE 


For some environments, additional rules about the construction 
of text file names exist; see the appropriate appendix for your 
environment. 


If a file with text other than a list of recipient identifications is 


used for a message header, or if recipients are not identified 
properly in the specified file, the Messenger will display 


3-12 


FA 


SENDING AND RECEIVING 


SMITHE: No such user 
when the S(end) option is used. 


Text files may be inserted into the body of a message in any 
order. To include a previously prepared text file at any point, 


type 
%filename <Return> 


on a separate line at the place where the file is to be inserted. 
Note that % must be placed in the first space of the line; other- 
wise it is treated like any other character. The Messenger will 
display the contents of the file as it is being used. Include as 
many files as desired, interspersed in any fashion with text 
entered from the keyboard. 


In the case of multiple insertions of large files, the maximum 
allowed message size may be used up (about 3800 
bytes/characters, or 760 words). A message such as 


***MEMORY OVERFLOW*** 


will then be displayed. The part of the message that fit into 
memory can be sent, together with a few more lines of text, by 
accepting it with <Esc> and using S(end). To start over, use 
<Esc>, Q(uit), and type SEND again from the Command level. 


The Messenger expects to have available the full memory space 
of a non-swapping 64K Apple. If you are using installable dev- 
ice drivers, turn on swapping mode to compensate for memory 
space taken by drivers (that is, include the line SWAP ON in 
Startcmd. Text). 
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Chapter 4 


Filing Mail 
omman Level Section Description or Menu Item 
F(ile) Cc 4.1 File new mail 
CLASSIFY C 4.2 Classify messages in 
one or more classes 
in mail file 


DECLASSIFY C 4.4 Remove message from 
classes in mail file 


RENAME C 4.5 Change the name of a 
mail-file class 

SHOW CIO 4.6 Display the current 

CLASSES classes 

DELETE C 4.7 Delete messages from 
mail file 

UNDELETE C 4.8 Recover messages 
accidentally deleted 

C = Command List I = Incoming Mail O = Outgoing Mail 


4.0 Filing Commands 


The Messenger's filing system is simple to use. Prompts are 
provided for the user by the system. Remember, however, that 
not all commands and menu items are available at all levels of 
the system. 


For instance, the F(ile menu item is only available at the incom- 
ing and outgoing message levels, for use with the message 
currently being read, sent, answered, or forwarded. In this list 
of commands and menu items above, five (CLASSIFY, 
DECLASSIFY, RENAME, DELETE, and UNDELETE) are avail- 
able only at the command level, and can not be used when the 
incoming or outgoing menus are being displayed. 
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4.1 The F(ile Menu Item 


The F(ile menu item saves a copy of the message that is 
currently being read, sent, answered, or forwarded, storing it in 
the user's mail file (as if it were an electronic filing cabinet). This 
file can be cross-indexed with as many as 24 subjects or 
categories (called “ciasses"). A message can be cross-indexed 
in any or all classes, and classifying and declassifying the mes- 
sages stored in them, are discussed in Sections 4.2 through 4.5. 


A mail class is simply a name chosen by the user to character- 
ize a set of messages; the class name can be used in com- 
mands to the mail system. 24 classes are allowed by the 
Messenger, and each filed message can belong to any set of 
them. In addition to any class names given to it, each filed mes- 
sage also has a message number that can be used to reference 
it. 


A new class name is created when the first message is put into 
that class. When a message is displayed, its message number 
and the classes to which it belongs are also displayed. 


When the F(ile option is selected from the Incoming or Outgoing 
menu, the Messenger asks 


Class? 
Respond with one or more class names (separated by commas) 
to file the message under specific class names, or with 


<Return> to file the message without a class. 


For example, at the Outgoing level, a message is composed 
and the Outgoing menu is displayed: 


Out: D(isplay) F(ile) P(rint) Q(uit) R(eceipt) S(end) W(rite)? 
F <Return> 


Class? MEETING, CUSTOMERS <Return> 


Filed message number 37 


oo, 
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In this example, the user, having composed a message, files it 
in two classes, MEETING and CUSTOMERS. As discussed in 
_the following sections, class names and message numbers are 
used to identify messages to be stored, displayed, and sent. 
Responding to the “Class?” prompt with <Return> causes the 
Messenger to file the message being sent without assigning it to 
any class. 


Alter filing the message, the Messenger redisplays the Incoming 
or Outgoing menu for further action at the current level. 


lf the mail file is full and no more messages can be filed in it, 
the Messenger will display, for example, 


Not enough free blocks; need 9, have 3 


(A block holds about 500 characters.) To save the current mes- 
sage when this occurs, use the Incoming menu's K(eep option 
to retain the message in the new mail queue; then make more 
room in the mail file by DELETING some messages from the 
mail file. (To save message before deleting them, P(rint them 
or W(rite them to a texifile first.) Execute READ to return to the 
new mail queue and F(ile the message waiting there. (DELETE 
and WRITE are discussed in sections 4.6 and 5.8.) 


4.2 The CLASSIFY Command 
The CLASSIFY command allows the user to add new classifica- 
tions to one or more messages saved in the mail file. The syn- 
tax is 

CLASSIFY <messages>,<classes> 
where <messages> describes which messages are to have 
classes added, and <classes> is a list of one or more class 
names. For example, 


“CLASSIFY33” 
‘Class? “COMPETITORS,.SALES" 
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(This example shows how information not supplied is asked for.) 


If, as in this example, the Messenger asks for the class name, 
the user can name a class or classes, or respond with “SHOW 
CLASSES" to have the current list of known classes displayed. 
The “Class?” question will then be asked again. Pressing 
<Return> or <Esc>- Return> returns the user to the Com- 
mand? prompt. 


When a class name is used that has never been used before, 
the Messenger prompts 


No class xxx exists. 
Create it (Y/N) ? 


For “Y”, the class name is entered into the class table and 
assigned to the messages; for “N”, the class is not created. 


If 24 classes already exist, the Messenger will display the mes- 
sage 


Too many classes 


lf this happens, the current message can be filed temporarily 
without a class. Before it can be placed in a new class using 
CLASSIFY, one or more existing classes must be removed 
using the RENAME command (Section 4.5) at the outer Com- 
mand level. 


Using the CLASSIFY command to place a message in new 
Classes does not create extra copies of the message with new 
message numbers; the single copy is simply recorded as a 
member of additional classes. 


As explained in the previous Section, this same sequence may 


be used when classes are being assigned to mail that is filed 
using the F(ile) option of the Incoming and Outgoing menus. 
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4.3 Specifying Messages in the Mail File 


Many of the Messenger commands operate on one or more 
messages in the mail file. There are many ways to specify which 
messages are to be affected by a command; a complete formal 
description is provided in 4.3.1 below. Some of the common 
ways, shown using the DISPLAY command (discussed in Sec- 
tion 5.1) are: 


(1) 


(2) 


(3) 


(4) 


(5) 


(6) 


A message number. Simply give the number of the mes- 
sage. 


Example: DISPLAY 21 


A message class. Give the name of a message class pre- 
ceded by “&” (ampersand) or by “œ” (at-sign). All mes- 
sages which belong to that class will be selected. 


Example: DISPLAY &MEETINGS 


A range of message numbers. Give the starting and end- 
ing message numbers separated by “:” (a colon). 


Example: DISPLAY 2:5 


All messages in your message file. Just say “ALL”. 


Example: DISPLAY ALL 


All unclassified messages. Type “&NONE” 


Example: DISPLAY &NONE 


The current message. The last message accessed in the 
mail file is refered to as the "current" message and can be 
specified by using ".” (period). 


Example: DISPLAY . 
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(7) The first, last, next, or previous message. “First” and 
“last” refer to the first message in the mail file (message 
number 1) and the last message in the mail file (the 
highest numbered message). “Next” and “previous” refer 
to the messages before and after the current message. 


Examples: DISPLAY F (first message) 
DISPLAY L (last message) 


DISPLAY P (previous message) 
DISPLAY N (next message) 


More complicated expressions can be constructed using these 
basic elements plus some others described in Section 4.3.1. 


Here are some examples and their interpretations: 
DISPLAY L-5 


Display the fifth message from the last. 


DISPLAY @NOTES IN 1:10 


Display any of the first ten messages that are also in the 
class “NOTES”. 


DISPLAY .!5 


Display the next five messages. 


In descriptions of the commands, the symbol <messages> is 
used to indicate that some messages from the mail file are to be 
specified. Use any of the ways to describe messages in place 
of the symbol <:messages>. For example, the DISPLAY com- 
mand is described as 


DISPLAY ~<messages> 
or 
DISPLAY <classes> 


no 
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and any of the examples in this section can be used in place of 
<messages>. 

4.3.1 Formal Definition of <Messages> 

The symbol <messages is used in the command description 
wherever the Messenger expects a specification of some subset 
of the messages in the mail file. The following is a formal recur- 
sive grammer specification of the syntax of <<messages>. 
<messages> ::= 


ALL 


All the messages in MAIL 


<expr> 


A single message, by number 


<expr1 > :<cexpr2> 


Message numbers from <expr1> to <expr2>, inclusive. 


<expri>!<expr2> 


<expr2> messages, starting with message number <expr1 > 


«@<classname> [IN <messages>] 


All messages in <messages> which are also in the class 
<classname>. IN ALL assumed if it is omitted. 
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<expr> ::= <number> A specific message number 
L The last message | 
F The first message 
The current message 
N The next message (.+ 1) 


P The previous message (.-1) 


<expri> +<expr2> 

The sum of two expressions (usually a message number plus a 
constant, like "F+2"). 

<expr>-<expr> 

The difference of two expressions (usually a message number 


minus a constant, like “L-1"). Multiple expressions are allowed 
and performed from the right: 1-2-3 =1-(2-3)=0. 


<classname> ::= <a 1-15 character name> 
<number> ::= <a positive integer> 


4.4 The DECLASSIFY Command 

The DECLASSIFY command allows the user to remove classifi- 
cations from one or more messages in the mail file. The syntax 
is: 


DECLASSIFY «:messages> ,<class> 


where <:messages:.- indicates which messages are to have 
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classifications removed, and <class> indicates which classifica- 
tion is to be removed. For example 

DECLASSIFY L,SALES 


will remove the last message in the mail file from the “SALES” 
Class, if the message is currently so classified. 


lf any of the specified messages are not in the named class, the 
prompt 


Message #nn is not in class. 
will appear. If there is no such class name, messenger displays 


No such class. 


4.5 The RENAME Command 


The RENAME command allows any classification name to be 
changed. The syntax is: 


RENAME <oldname>,<newname> 


where <oldname> is the current name of the classification, and 
<newname> is the new name of the classification. For exam- 


ple, 
RENAME DATES,APPOINTMENTS 


This moves all messages in the DATES class to a new class 
named APPOINTMENTS, and the DATES class no longer 
exists. This does not affect any of the other classes that mes- 
sages in DATES might also have been in. | 


RENAME can be used to eliminate unwanted classes com- 


pletely (e.g., when 24 classes have been named, and room for 
new class names is needed). For example, 


RENAME DATES, <blank> 
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will remove the classification DATES from all messages filed in 
that class. The Messenger will make sure that <newname> is 
not being forgotten by asking “New Class?". Type <Return>- 
and DATES will be eliminated as a class name. The Messenger 
will display the message number and subject header of each 
message in DATES as it is declassified. 


Typing RENAME <blank> ,newname will create an empty class 
named newname. 


4.6 The SHOW CLASSES Command 


The command SHOW CLASSES lists all the classification 
names that are currently defined. At the Command level, type in 
SHOW CLASSES in response to the prompt “Command?”, or 
to “Class?”, which appears when the commands CLASSIFY or 
DECLASSIFY are given. At the Incoming or Outgoing menu 
levels, after selecting the F(ile) option, type in SHOW CLASSES 
when the Messenger prompts with “Class?”. For example, 


Command? classify 5 <Return> 


Class? show classes <Return> 
CONTRACTS DATEBOOK 
AUDITS AJAX FILE 
FISCAL 


5 of 24 classes are named 
Class? Fiscal <Return> 


Here, the user has decided to classify message number 5 in the 
mail file, but wishes to see a listing of current classes first. 
Message 5 is then classified in “Fiscal”. 


The same action at the Incoming level: 


In: A(nswer) D(isplay) F(ile) FO(rward) K(eep) N(ext) 
P(rint) Q(uit) W(rite)? E<Return> 


Class? show classes <Return> 
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CONTRACTS DATEBOOK 
AUDITS AJAX FILE 
FISCAL 


5 of 24 classes are named 
Class? Fiscal <Return: 


Pressing <Return> in response to the prompt “Class?” at 
the Incoming and Outgoing levels will cause the Messenger 
to file message 5 without classifying it. 


4.7 The DELETE Command 


The DELETE command is used to remove one or more mes- 
sages from the mail file. The syntax is 


DELETE <messages> 


where <messages> describes which messages are to be 
deleted. 


DELETE 1:10 
DELETE &NOTES 


As each message is deleted, its message number will be 
displayed. If, in the example above, a message belongs to the 
class &NOTES and to another class, it_will not be deleted , but 
only removed from the class &NOTES. 


WARNING: Message numbers are always consecutive in the 
Messenger. For example, immediately after deleting, for exam- 
ple, message number 12, the message whose number was 13 
is now 12, the message whose number was 14 is now 13, etc. 
Take care, in doing a sequence of DELETE commands, that this 
implicit renumbering of the messages does not cause accidental 
deletions of the wrong messages. To delete several messages 
by message number, delete the highest numbered messages 
first. 
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4.8 The UNDELETE Command 


The UNDELETE command is a seldom-used command that 
retrieves filed messages that have been accidentally deleted. 
The syntax is simply 


UNDELETE 


All previously deleted messages that can be recovered will be 
filed at the end of the user's mail file. If no new messages have 
been filed since the last DELETE command, then at least all the 
messages recently deleted will be recovered. It is likely that 
additional messages deleted earlier will also be recovered, in 
which case it may be necessary to display all the recovered 
messages and delete those not wanted. 


Undelete will not retrieve messages that were read but not filed. 


Chapter 5 


Using Filed Mail 
mmand Level tion D iption or Menu It 
DISPLAY, C 5.0 Display filed mail 
D(isplay) 1,0 3.6 Display current message 
HEADERS C 5.1 Display only the headers 
. of filed mail 
ANSWER, C 5.2 Answer a filed message 
A(nswer) l 3.1 Answer current message 
FORWARD, C 5.4 Forward a filed message 
F(orward) | 3.1 Forward current message 
RESEND C 5.7 Send a filed message 
WRITE, C 5.8 Write a filed message to a 
text file or local printer 
Write) O 3.1 Write current message 
to a text file or local 
printer 
PRINT, C 5.9 Print a filed message 
on system printer 
P(rint) 1,0 3.1 Print current message 
on system printer 
C = Command Level | = Incoming Mail O = Outgoing Mail 


5.0 The DISPLAY Command 


The DISPLAY command, when typed at the Command level, is 
used to display one or more messages (both header and body) 
that have been filed in the user's mail file. When selected from 
the Incoming or Outgoing mail menu, D(isplay) redisplays the 
message that has just been read or composed. At the Com- 
mand level, the syntax is: 


DISPLAY <messages> 


where <messages> describes which messages are to be 
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displayed. For example, 
DISPLAY L 


displays the last message (the one most recently filed) in the 
mail file. As discussed in Section 4.4, there are many ways to 
specify which messages are to be affected by a command; a 
complete formal description is given in Appendix A. The most 
common ways are to give the number of the message, or 
specify “ALL”, or give the name of a message class or range of 
message numbers. 


Remember that, as with other commands, there are two ways to 
interrupt the output of the DISPLAY command: 


(1) Temporarily, using the key for your environment that 
freezes and restarts screen displays (see your environ- 
ment appendix). 


(2) Permanently, using the break or abort key (see the appen- 
dix for your environment). The Messenger will display 
“..ABORTED” and return to the outer command level. 
However, this key is for use with operations in progress 
only, not for static prompts such as “Class?”. Also, when 
displaying new messages, the Messenger will stop 
automatically when the screen is full, and ask MORE 
(Y/N)? 


5.1 The HEADERS Command 

The HEADERS command will print a one-line summary of one 
or more messages that have been filed in the mail file. The 
command syntax is 


HEADERS <:messages> 


where <messages> describes which messages are to be sum- 
marized. For example, 
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HEADERS ALL 
HEADERS output has the format 


#1< =Smith Tue 19-Feb Tomorrow's meeting[1] 
#2 = >Jones Tue 19-Feb Audit for meeting[1] 
#3=>JDN,SKF,... Wed 20-Feb Audit format([2] 


... and soon... 


The number in the first column of this example is the message 
number in the mail file; this number can be used to refer to this 
message as part of the <messages> item in other commands. 
The arrow indicates whether the message was to ( = > ) or from 
( <= ) the person listed in the next column. If the message was 
sent by the user to other people, then the arrow will point to the 
right 


=> names 
An ellipsis (...) will appear if there are too many names to fit in 
the field. For a message to the user from someone else, the 
arrow will point left 

<= name 
away from the initials of the sender. 
The next two fields display a partial date and the subject of the 
message. The last field in each header, in parentheses, gives a 
rough idea of the length of the message; each increment 
corresponds to about 500 characters. 
5.2 The ANSWER Command 
The ANSWER command is a variant of the SEND command, 
used to reply to messages stored in the mail file. ANSWER sup- 


plies suggestions for some of the header fields, to make it 
easier to compose a response to the filed message. 
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To use the ANSWER command, type 
ANSWER <messages> 


where <messages> identifies the message (or messages, 
although there usually will be only one) in the mail file to be 
answered. 


The sequence described here for the ANSWER command can 
also occur by selecting the A(nswer) option of the new mail 
menu. in that case the message being answered is the one 
being read. 


Note: The Messenger cannot ANSWER, FORWARD, or 
RESEND long messages, and will display “Memory Overflow” to 
indicate that a message is too long for ANSWER to be used. 


When constructing the header of the message using ANSWER, 
the Messenger will suggest values based on the header lines of 


the message being answered or forwarded. The sender can 
either 


(1) accept the suggested value by pressing <Return>, or 


(2) remove the suggestion by typing a blank followed by 
<Return>, or 


(3) supply a substitute by typing it followed by <Return>, or 


(4) add to the suggested value by typing in 


,<addition> <Return>. 


If the sender supplies a substitute for the suggested value, the 
Messenger will again display the information for confirmation, 
this time using the substitute as the suggestion. It will continue 
to prompt with suggested values until <Return> only is 
pressed. . 
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5.3 Header Line Suggestions Supplied by ANSWER 


These are the suggestions supplied automatically by the 
Messenger for the header lines of a message that is answering 
an earlier message: 


(1) For the “TO” header line, the suggested value is the 
sender of the message being answered. 


(2) For the “CC” header line, the suggested value is the con- 
catenation of the “TO” and “CC” header lines of the mes- 
sage being answered, except that the current sender is 
removed. 


(3) For the “SUBJECT” header line, the suggested value is 
the subject of the message being answered, with “Re:" 
before it. 


When the header has been completely constructed, enter the 
body of the message just as for the SEND command. The out- 
going mail menu, as for the SEND command, is then used to 
control the disposition of the message. 


5.4 The FORWARD Command 
The FORWARD command is a variant of the SEND command. 
Use it to send a message from the mail file to one or more peo- 
ple, along with any desired prefatory remarks. 
To use the FORWARD command, type 

FORWARD <messages> 
where <messages> identifies the message (or messages, 
although there usually will be only one) in the mai! file to be for- 
warded. 
Note: The sequence described here for the FORWARD com- 


mand can also occur by selecting the FO(rward) option of the 
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Incoming mail menu (Section 3.1.1). In that case the message 
being forwarded is the one currently being read. As with the 
ANSWER command, the Messenger cannot FORWARD long 
messages and will display “Memory Overflow” to indicate that a 
message is too long to be forwarded. 


The Messenger expects to have available the full memory space 
of a non-swapping 64K Apple. If you are using installable dev- 
ice drivers, turn on swapping mode to compensate for memory 
space taken by drivers (that is, include the line SWAP ON in 
Startcmd. Text). 


5.5 The FORWARD Header 


When constructing the header of the message using FOR- 
WARD, the Messenger will, as with ANSWER, suggest values 
based on the header lines of the message being answered or 
forwarded. Either 


(1) accept the suggested value, by pressing <Return> or 


(2) supply a substitute by typing it followed by <Return>. To 
remove the suggestion and leave it blank, type a blank fol- 
lowed by <Return>. Or 


(3) add to the suggested value by typing 


,<addition><Return>. 


If a substitute is supplied for the suggested value, the 
Messenger will again ask for the information, this time using the 
replacement as the suggestion. It will continue to prompt with 
suggested values until one is accepted. Again, press <Return> 
to do this. The substitute can include external files by using the 
%file notation. 
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5.6 Header Line Suggestions for FORWARD 


The Messenger supplies these suggesions for headers of for- 
warded messages. 


(1) For the “TO” header line there is no suggested value; sup- 
ply the direct recipients just as for SEND. 


(2) For the “CC” header line there is no suggested value; sup- 
ply the CC recipients just as for SEND. 


(3) For the “SUBJECT” header line, the suggested value is 
the subject of the message being answered, with “Re: ” 
before it. 


After the header has been constructed, the Messenger prompts 
for a preface to the message: 


Enter preface or %filename, 
terminate with <Esc> <Return> 


Enter the text of the preface just as for the body of a message 
being composed with SEND. When the preface is finished, type 
<Esc>. The Messenger then will append the message being 
forwarded, surrounded by the lines 


--- BEGIN FORWARDED MESSAGE --- 
--- END FORWARDED MESSAGE --- 


so that it is clear to the recipients that the message is imbedded 
within another message. 


After the forwarded message has been copied, the standard 
outgoing mail menu is used to control the disposition of the 
entire package, including the new header, preface, and the 
embedded message. 
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5.7 The RESEND Command 


The RESEND command is used to send messages that have 
been filed in the user's mail file: 


Command? Resend <Return> 
Message range? 3<Return> 


The Messenger will prompt for recipient and copies using the 
identifiers in the filed headers. These may be changed by the 
user in the same way as the FORWARD and ANSWER 
prompts: 


To: Smith? <Return> 


CC: Jones,Brown? <Space><Return:> 
CC:? <Return> 


Copying message... 
OUT:D(isplay) F(ile) P(rint) Q(uit) R(eceipt) S(end) W(rite)? 


Here, after requesting that filed message #3 be sent, the user 
accepts the To: prompt by pressing <Return>, and changes 
CC: from “Jones,Brown" to "no copies" by pressing the space 
bar and <Return>.The Messenger then prepares the message 
to be sent ("Copying message...") and displays the Outgoing 
mail menu. 


Messages in a class can be sent by entering "&classname" in 
response to the "Message range?” prompt. 


As with the ANSWER and FORWARD commands, the 
Messenger will not RESEND long messages, and will indicate 
with "Memory Overflow” that a message is too long for use with 
RESEND. 
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5.8 The WRITE Command 


The WRITE command is used to write one or more messages to 
a text file or local printer. The syntax is: 


WRITE <messages> 


where <messages> specifies which messages are to be writ- 
ten. The Messenger asks 


To what file? 


Respond with the name of the text file to be created or written 
into; see the appropriate appendix for your environment for 
information about filename conventions and using a local printer. 
Messages to be printed can be specified in the same way as 
messages to be displayed or written. See the appendix for your 
environment for the exact syntax. See also Section 4.4. Both 
the header .and body of each message are written, and the 
number of the message is displayed on the screen as it is writ- 
ten to the file. As with all commands, the user break or abort 
key for your environment will abort the operation. 


WARNING: The write command DOES NOT append messages 
to a file of messages. When a file name is specified and the file 
already exists, everything in it is replaced. However, the 
Messenger will warn that this is about to happen. 


For example, suppose that Mr. Jones decides to store all of his 
correspondence regarding company audits in a text file, and 
issues the command 


WRITE &AUDITS 
The Messenger asks, 
To what file? Audits 
# 4: =>>-SMITHWed 10-Jun Audit Needs[1] 


# 8: < =SMITHTues 14-Jul Audit Situation[2] 
etc 
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Later in the day Mr. Jones decides to add a new message and 
issues the command 


WRITE 11 
To what file? Audits 





The warning will appear 


OK to overwrite existing AUDITS.TEXT 
(Y/N)? 


Mr. Jones must write his new message to another file and 
merge the files using an editor in his environment. If he replies 
“Y” to the prompt, the messages written earlier will be erased. 
Refer to the appropriate appendix for your environment for infor- 
mation about file name conventions. 


The write command can be used to print messages on a local 
printer (on which is connected directly to your workstation). See 
the appendix for your environment for detailed instructions about 
this feature. 


5.9 The PRINT Command 


The PRINT command can be used at any level of the 
Messenger to print messages on a shared printer if your infor- 
mation has the Print Server subsystem option. PRINT creates 
print-request files that specify which messages are to be 
printed. These request files are read by the Printer Server Pro- 
gram, which causes the specified messages to be printed. The 
Printer Server need not be in operation when the print requests 
are queued. 


Messages to be printed can be specified in the same way as 
messages to be displayed or written. A complete description of 
syntax is given in Appendix A. For example, 


o 


FILED MAIL 


Command? Print 


Message Range? 1:2 

# 1: <=SmithThu 09-Jul Re:Audit Plans[2] 
# 2: =>JonesFri 10-Jul Re:Audit Snafu[1] 
Print request queued 

Command? 


and the Messenger has queued the messages filed #1 and #2. 
At the Incoming and Outgoing menu levels, selecting menu item 
P(RINT) causes the Messenger to queue the message currently 
being read, sent, or otherwise manipulated. 
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Other Commands 


mman Level ection Description or Menu Item 

CLEAR C 6.1 Clear the screen 

HELP C 6.2 Display a command 
summary 

"9" ClO 6.3 Prompt for next action 

NEWS C 6.4 Display news about the 
system 

INFO C 6.5 Displays local information 

NET C 6.6 Issue Network File 
Server commands 

SHOW C 6.7 Display miscellaneous 
information 

Q(UIT) C,,O 6.8 Return to previous level 

C = Command Level | = Incoming Mail O = Outgoing Mail 


6.0 Other Commands 

With the exception of Q(uit) and "?”, these commands are avail- 
able only at the Command level. 

6.1 The CLEAR Command 


The CLEAR command clears the display screen. 


6.2 The HELP Command 


The HELP command displays one-line summaries of most of the 
commands available at the Command level of the Messenger. 
For example, 


OTHER COMMANDS 


Command? Help 
Commands are: 
ANSWER «<msgseq-> - Reply to message(s) 
CHECK - Continually check for new incoming mail 
CLASSIFY........ 


and so on. 


6.3 The “?” Command 


Entered in response to any prompt, "?" causes the Messenger 
to explain what the user is expected to do next. For example, 


Command? ? 

Enter <cmd> [<operand>] or HELP to list commands 
and 

Command? send 

To: 22 


Initials, or %file, or RETURN to accept default To: ? 


6.4 The NEWS Command 


The NEWS command displays the contents of a news file. The 
news file is maintained by the System Manager at each installa- 
tion, and can contain information specific to the Messenger, or 
information of a more general nature. 


6.5 The INFO Command 
The INFO command displays the contents of an information file. 


The information file is maintained by the system manager and 
can contain anything of interest to the users. 


6-2 


OTHER COMMANDS 


6.6 The NET Command 


The NET command is used to issue commands to the file 
server. There are two forms: 


NET <command> 


This form allows the user to specify a single NET com- 
mand. The Messenger executes the command and 
returns the user to the Command level. 


NET 


This form allows the user to enter a submode from which 
to enter repeated NET commands. The Messenger 
prompts with 


NET command or Q(uit): 


Enter any NET command, except “local” commands. 
The command will be executed and the prompt repeated. 
Entering “Q” causes the Messenger to return to the 
Command level. 


One common use of the NET command is to MOUNT a virtual 
disk, onto which filed messages can be written using the WRITE 
command, and from which text files can be copied into headers 
and messages using the % option. 


The NET command SET DIR should not be used from the 
Messenger. SET DIR is used by the mail system in reading new 


mail; changing directory default values will prevent the system 
from reading new messages. 


6.7 The SHOW Command 


The SHOW command can be used to display various informa- 
tion about the Messenger and its environment. The syntax is: 
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SHOW <option > where -option ~ is one of the following: 
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CLASSES Display the classifications of mail in the mail 
file. 


VERSION Display the version number of the Messenger 
being used. 


FREE Display the number of free blocks in user's 
mail file. Each free block can store about 
500 characters. 


SPACE Display the amount of free space in the local 
memory of the computer. The free space is in 
“words” and each word can hold 2 characters 
(for use in UCSD Pascal environments only). 


The QUIT Command or Menu Item 


The QUIT Command, entered as “Q” at all three levels, returns 
the user to the previous level: 


Typing “Q” at the Command level cause the user to exit 
from the Messenger. 


Typing “Q” from the Incoming menu returns the user to the 
Command level. 


Typing “Q” from the Outgoing menu returns the user to the 
Incoming menu or to the Command level, depending upon 
which command, SEND, ANSWER, or FORWARD, was 
used to reach the Outgoing level. 
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Tailoring Your System 


7.0 Automatic Startup 


Your network has various startup command facilities that can be 
used to facilitate entry into the mail system via the processing of 
STARTCMD and/or DEFAULTS files. 


7.1 Startcmd File 


A user station can be configured so that a startup program is 
automatically executed when the station is booted. This program 
attempts to read a file called STARTCMD (the file name 
includes a suffix in some environments) from the prefixed or 
logged in disk and interprets each line in the file as a command. 
In some environments, including the word "MAIL" as a com- 
mand line in STARTCMD will cause the mail system to run 
automatically when the station is booted. STARTCMD com- 
mands that do not relate to the mail system are described in 
detail in the PLAN File Server User's Manual. 


The Messenger expects to have available the full memory space 
of a non-swapping 64K Apple. If you are using installable dev- 
ice drivers, turn on the Pascal swapping mode to compensate 
for memory space taken by your drivers (that is, include the line 
SWAP ON in Startcmd. Text.) 


7.2 Defaults File 

When the Messenger is executed, its first action is to read the 
user's DEFAULTS file. (The filename includes a suffix in some 
environments). Any command lines in this textfile that begin with 


the word “Mail:" are executed automatically. 


The following mail commands are allowed (all commands must 
be preceded by “mail:"; upper and lower case are allowed). 
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Underlined values are variables input by the user. Information 
specific to a workstation environment is found in the appropriate 
environment appendix at the back of this manual. 
Mail: Set User name 
Identifies the user as “name”. The Messenger will mount 
/PREFIX;NAME:MAIL 
and 
/PREFIX/NAME;NEWMAIL/MESSASGED 
automatically. A password may be included, in the form 
name:password. When the Set User command is present, 
the Messenger will not ask "Who are you?” at initialization. 
Mail: Set DriveA x 
Sets the drive letter or number used for filed mail to x; oth- 
erwise the Messenger looks for any available drive. The 
drive must be virtual. 
Mail: Set DriveB y 
Sets the drive letter or number used to mount new mail to 
y; otherwise the Messenger looks for any available drive. 
Drive must be virtual. 
Mail: Set Height n 
Sets screen page height to n lines; default is 24. When 
displaying messages, the Messenger asks MORE?(Y/N) 
after n lines. 


Mail: Set Width n 


Sets screen width to n columns. Screen width will affect the 
formatting of some prompt lines. The default is 80. 
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Mail: Set Prefix path 


Sets pathname prefix for mail and newmail files. Default is 
/MAIN/USERS. READ access must be provided for all 
directories in the prefix path. Passwords may be included. 
All users of the Messenger must have the same prefix and 
Newmail; otherwise, messages will not be sent correctly. 


Mail: Set Mailfile path 


Sets the complete pathname for Mailfile. This command 
overrides default pathname PREFIX/USER/MAIL and uses 
the specified pathname. READ, WRITE access must be 
provided. Passwords may be used. 


Mail: Set Newmail name 


Sets final name of Newmail pathname, appended to 
PREFIX/‘USER/. Used for incoming and outgoing mail. 
Default is “NEWMAIL”. DELETE and READ access must 
be provided for the NEWMAIL directory, and CREATE 
access must be provided for outgoing newmail directories. 
Passwords may be included. 


Mail: READ 


Causes the Messenger to automatically execute the READ 
command after initialization. 


Mail: CHECK 
Causes the Messenger to automatically execute the 
CHECK command after initialization. 
7.3 Access, Usage, and Protection 
Network file protection facilities are discussed in detail in the 
PLAN File Server User's Manual. Briefly, the mail system user 


can prevent access to his or her Mail and Newmail files by set- 
ting passwords in the file pathnames and limiting public and 
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group access rights to those files. From within the mail system, 
this is accomplished by issuing FS PROTECT commands. For 
example, 


FS PROTECT MAIN/USERS:SMITH: NEWMAIL, 
PUBACC - C.GRPACC - ,PRVACC = RWECD,PRVPW = XYZ 


causes the private password "xyz" to be set for Smith's Newmail 
file, and read and write access to be restricted to private use. 
No group access is allowed, but the public is given "create" 
access so that messages from other mail users can be created 
in the Newmail directory. The Mail file is accessed only by the 
user who owns it; there need be no public access to it at all. 


The following access must be provided for the system to func- 
tion: 


(1) READ access for Mail/Newmail prefix (all users must have 
same prefix and Newmail). 


(2) READ and WRITE access for your own Mailfile. 


(3) DELETE and READ access for your own Newmail direc- 
tory. l 


(4) CREATE access for other Newmail directories. 


A private password, once it has been set, can be entered in 
several ways: 


(1) By issuing a Network “SET PRVPW" command from the 
NET program before the Messenger is used. 


(2) By including the SET PRVPW command in the 
STARTCMD file. 


(3) By including the private password in the appropriate Mail 
Set commands in the user's DEFAULTS file. 


The system default is no protection. 
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The Nestar CVAL Convention 
for Apple Pascal 


8.0 Introduction 


If you are an applications programmer, you will need to know 
how your Nestar programs can be used with the rest of your 
programs. This chapter describes the Nestar convention for 
chaining programs. 


8.1 CVAL 


Pascal Releases 1.1 and later allow one program to chain to 
another, and provides for a global string called CVAL to be 
passed as a parameter. 


See the Pascal Language Reference Manual for a discussion 
of chaining programs in the Pascal environment. To use these 
procedures in the network environment with the Nestar shared 
library, the line 


USES CHAINSTUFF; 


that immediately follows the Program heading must be replaced 
by 


USES (*$U LIB:NESTAR.LIB*) CHAINSTUFF; 


The Nestar definition of the CVAL variable allows it to be used 
both to specify a series of program to be executed, and to sup- 
ply parameters to those programs. Programs which obey this 
convention can thus be called as subroutines or be linked in a 
chain of consecutive program executions. 
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8.2 Format of CVAL String 


The general format of the CVAL string as a program begins exe- 
cution is: 


parm//program2, parm2//programs3 ... 


where “parm” is a parameter that is being passed to the current 
program. When it terminates, program’ is the next program to 
be executed, and it is passed the string starting with parma. 


For example, if the CVAL string has the following value when 
program ABC is executed 


verbose//DEF,nosend 


then program ABC will be executed with “verbose” as a param- 
eter, after which program DEF will be executed with “nosend” 
as a parameter. 


8.3 Complex Chain Sequences 


Complex CHAIN sequences may be implemented by programs 
which add to as well as remove names from the CVAL string. 
Two procedures that manipulate the CVAL string in accordance 
with this convention are shown here: 


GETPARM (parm-string); 


This procedure sets “parm-string” to the parm provided to this 
program. In addition, if a CHAIN program name was given then 
a SETCHAIN is done (for this reason, GETPARM should be 
called even if the invoking program doesn't expect/accept a 
parm). This procedure should only be called once per program 
since multiple calls will unstack multiple parm/program list 
entries. 


SETPARM (parm-string, program-name-string); 


This procedure sets the parm for the next program which will be 
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executed. In addition, the program name of the program to be 

executed after the next program has completed can be specified 

(e.g, the program name could be the original program name to 

~ cause a “return” to the original program when the next program 

i has completed). SETPARM always returns and multiple SET- 
PARM calls are legal (to set up a list of programs to execute). 


PROCEDURE GETPARM (VAR PARM:STRING): 


VAR 
P: INTEGER; 
CVAL,PGM:STRING; 


BEGIN 
GETCVAL (CVAL); 
P := POS (‘/,CVAL); (“find the end of our 
parm*) 
IF P = O THEN BEGIN 
PARM := CVAL; 
(m CVAL := " 
END 
ELSE BEGIN 
PARM := COPY (CVAL,1,P-1); 
DELETE (CVAL,1,P +1); 
P := POS (,, ,CVAL); 
IF P = O THEN BEGIN 


PGM := CVAL; 
CVAL :-- ” 
END 
ELSE BEGIN 


PGM := COPY (CVAL,1,P-1); 
DELETE (CVAL,1,P) 

END; 

IF PGM <> ” THEN SETCHAIN (PGM); 

(* XCTL pgm name *) 
END; 
aoe SETCVAL (CVAL) 
END; 


CVAL 


PROCEDURE SETPARM (PARM,PGM:STRING); 


VAR 

CVAL: STRING; 
BEGIN 

GETCVAL (CVAL); 


SETCVAL (CONCAT (PARM, ‘/,PGM,‘,",;CVAL)) 
END; 
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Appendix A 


Using the Messenger Program in the 
Apple // PASCAL Environment 


A.0 Introduction 


This Appendix includes instructions and information specific to 
the Apple // Pascal environment. It is meant to be read in con- 
junction with Chapters 1-8 of this manual. It includes the follow- 
ing information and instructions. 


(1) 


(2) 


(3) 


(4) 


(5) 
(6) 


Invoking the mail program (to be read in conjunction with 
Chapter 2). 


Invoking the mail program automatically at startup of your 
workstation (to be read in conjunction with Chapter 2). 


Proper syntax of file names when storing and using text 
files in conjunction with the mail program (to be read in 
conjunction with Chapters 5 and 6). 


Printing messages on a local printer (to be read in con- 
junction with Section 5.9). 


Freezing the screen display. 


Aborting an operation. 


A.1 Invoking the Mail Program 


The mail program resides on 


/MAIN/LIB/APPLE2/UCSD/PASCAL 


which is the shared library volume for this environment. 


APPLE // PASCAL 


To invoke the mail program, select the execute function from the 
main Pascal command line by typing “X”. Then supply the fol- 
lowing specifier: 


LIB:MAIL 


A.2 Invoking the Mail Program Automatically upon 
Startup of Your Workstation 


The network software includes special auto-start features that 
can cause your mail program to be invoked automatically when 
your system is powered up. In order to make use of this capabil- 
ity, you will need to add instructions to your Startcmd.Text file, 
which is located on your boot volume. Including the word 
“MAIL” as a command line in Startcmd.Text will cause the mail 
system to be run automatically when the station is booted. 


To learn how to configure this Startcmd.Text file you will need to 
refer to the User’s Guide for the Apple // Pascal Environment. 


The Messenger expects to have available the full memory space 
of a non-swapping 64K Apple. If you are using installable device 
drivers, turn on the Pascal swapping mode to compensate for 
memory space taken by your drivers (that is, nclude the line 
SWAP ON in Startcmd. Text.) 


When the Messenger is executed, its first action is to read the 
file DEFAULTS.TEXT, if it exists on the boot volume. Any com- 
mand lines in this textfile that begin with the word “MAIL:” are 
executed automatically. Section 3.2 explains what mail com- 
mands can be in DEFAULTS.TEXT. In the commands “Set 
DriveA x” and “Set DriveB y”, the x and y should be Pascal 
drive numbers such as 9 or 10. 


You should get together with your system manager if you would 
like to use these automatic start-up features. 


Your system manager may have already configured your 
Startcmd.Text file to include startup of the mail program. If you 
don't like this, it can be changed. Speak with the system 
manager about it. 
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A.3 Proper Syntax for File Names when Storing 
and Using Text Files 


In Chapters 5 and 6, we tell you how to file messages and how 
to use text files as messages. There are some rules about 
specifying file names under the Apple // Pascal Environment 
which are important for you to know. 


When you use the “Write” command or menu option, you are 
asked for a file name. When you read in the text of a message 
from a file, you will need to specify a file name. 


When you are specifying these file names there are some Pas- 
cal conventions you should keep in mind. 


If you ask for a text file to be created or found and you supply a 
name without the .text extension, that extension will be 
appended. 


If you ask for a file to be created or found and you supply a 
name which has a .text extension, the file created or found will 
have the exact file name that you typed including the .text 
extension. 


If you ask for a file to be created or found and you end the file 
name with a period, the file that is created or found will not (can 
not) have a .text extension. 


Examples of instances involving these conventions are as fol- 
lows: 


(1) If you ask for “mymail” to be created a file called 
“mymail.text” will be created. 


(2) If you ask that a file called “Letter.text” be used as a mes- 
sage (after the % character). The file “Letter.text” will be 
used, 


(3) If you ask that a file called “#3:appointments.” be used as 
a message, the file called “#3:appointments” will be used. 
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In this case, if there is a file called “appointments.text” on 
the volume Smith: (which can be specified as #3:), that 
file will not be used because the existence of the period in 
your specification tells Pascal not to automatically append 
text to your specification, but to look instead for a file 
name that exactly matches your specification. 


(4) If you create a file and supply the name “goals.”, the file 
will be created and will be called “goals”, not “goals.text”. 


NOTE: In the above examples we have sometimes specified 
the volume and sometimes not. You should know that if you 
want to retrieve or create a file, you will need to specify the 
volume name or number only if the volume you are specifying is 
not your prefix volume. 


A.4 Printing Messages on a Local Printer 

If you intend to use a local printer for printing mail messages, 
you must have the appropriate interface card for your printer 
installed in slot 1 of your Apple // computer. You must set drive 
6 real, either by executing LIB:NET, or by modifying the 
Startcmd.text file on your boot volume. 


Having invoked the MAIL program, you can then invoke the 
“Write” function from any of the three levels. 


(1) You can type “WRITE” after the Command? prompt. 


(2) You can select the “Write” option from the Incoming Com- 
mand option line by typing “W”. 


(3) You can select the “Write” option from the Outgoing Com- 
mand option line by typing “W”. 


When you select this option you will to asked the following: To 
what file? 
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Your response can be either of the following: 
Printer: 
or 


#6: 


A.5 Freezing the Screen Display 

Type <Ctrl>S to freeze a scrolling screen display (such as a 
listing of all headers), and <Ctri>S to resume scrolling. 

A.6 Breaking/Aborting Operations 


To break or abort a screen display or other Messenger opera- 
tion, type -<Ctrl:>C. 
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Appendix B 


Using the Messenger Program 
in the Apple /// SOS Environment 


B.0 Introduction 

This Appendix includes instructions and information specific to 
the Apple /// SOS environment. It is meant to be read in con- 
junction with Chapters 1-8 of this manual. It includes the follow- 


ing information and instructions. 
Pascal environment. 


(1) Invoking the mail program (to be read in conjunction with 
Chapter 2). 


(2) Invoking: the mail program automatically at startup of your 
workstation (to be read in conjunction with Chapter 2). 


(3) Proper syntax of file names when storing and using text 
files in conjunction with the mail program (to be read in con- 
junction with Chapters 5 and 6). 


(4) Printing messages on a local printer (to be read in conjunc- 
tion with Section 5.9). 


(5) Freezing the screen display. 


(6) Breaking/Aborting Operations. 


B.1 Invoking the Mail Program 
The mail program resides on 
/MAIN/LIB/APPLE3/SOS 


which is the shared library volume for this environment. 


B-1 


Apple /// SOS 


To invoke the mail program, select the execute function from the 
main Pascal command line by typing “X”. Then supply the fol- 
lowing specifier: 


/LIB;/MAIL 


B.2 Invoking the Mail Program Automatically upon 
Startup of Your Workstation 


The network software includes special auto-start features which 
can cause your mail program to be invoked automatically when 
your system is powered up. In order to make use of this capabil- 
ity, you will need to add instructions to your Startcmd.Text file, 
which is located on your boot volume. Including the word 
“MAIL” as a command line in Startcmd.Text will cause the mail 
system to run automatically when the station is booted. 


To learn how to configure this Startcmd.Text file you will need to 
refer to the User's Guide for the Apple /// SOS Environment. 


When the Messenger is executed, its first action is to read the 
file DEFAULTS.TEXT, if it exists on the boot volume. Any com- 
mand lines in this textfile that begin with the word “MAIL:” are 
executed automatically. Section 3.2 explains what mail com- 
mands can be in DEFAULTS.TEXT. In the commands “Set 
DriveA x” and “Set DriveB y”, the x and y should be virtual SOS 
device numbers such as 2 or 3. 


You should get together with your system manager if you would 
like to use these automatic start-up features. 


Your system manager may have already configured your 
Startcmd. Text file to include start up of the mail program. If you 
don't like this, it can be changed. Speak with the system 
manager about it. 
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B.3 Proper Syntax for File Names when Storing 
and Using Text Files 


In Chapters 5 and 6, we tell you how to file messages and how 
to use text files as messages. There are some rules about 
specifying file names under the Apple /// SOS Environment 
which are important for you to know. 


When you use the “Write” command or menu option, you are 
asked for a file name. When you read in the text of a message 
from a file, you will need to specify a file name. 


When you are specifying these file names there are some Pas- 
cal conventions you should keep in mind. 


If you ask for a text file to be created or found and you supply a 
name without the .text extension, the file created or found will 
have the exact file name that you specified. 


If you ask for a file to be created or found and you supply a 
name which has a .text extension, that extension will be 
appended. 


lf you ask for a file to be created or found and you end the file 
name with a period, the file that is created or found will not (can 
not) have a .text extension. 


Examples of instances involving these conventions are as fol- 
lows: 


(1) If you ask for “mymail” to be created a file called 
“mymail.text” will be created. 


(2) If you ask that a file called “Letter.text” be used as a mes- 
sage (after the % character). The file “Letter.text” will be 
used. 


(3) If you ask that a file called “.N1/appointmenrs.” be used as 
a message, the file called “.N1/appointments” will be used. 
In this case, if there is a file called “appointments.text” on 
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the volume /SMITH, (which can be specified as .N1) that 
file will not be used because the existence of the period in 
your specification tells Pascal not to automatically append 
.text to your specification, but to look instead for a file name 
that exactly matches your specification. 


(4) If you create a file and supply the name “goals.”, the file 
will be created and will be called “goals”, not “goals.text”. 


NOTE: In the above examples we have sometimes specified the 
volume and sometimes not. You should know that if you want to 
retrieve or create a file, you will need to specify the volume 
name or number only if the volume you are specifying is not 
your prefix volume. 


B.4 Printing Messages on a Local Printer 

If you intend to use a local printer for printing mail messages, 
you must have the appropriate interface at the rear of your 
Apple /// computer. And, you must have the appropriate printer 
driver code file in the SOS.Driver file on your boot volume. 
Finally, you must know the device name of your printer driver 
file (i.e. .Printer). 


Having invoked the MAIL program, you can then invoke the 
“Write” function from any of the three levels. 


(1) You can type “WRITE” after the Command? prompt. 


(2) You can select the “Write” option from the Incoming Com- 
mand option line by typing “W”. 


(3) You can select the “Write” option from the Outgoing Com- 
mand option line by typing “W”. 


When you select this option you will to asked the following: 


To what file? 


oa 


Apple /// SOS 


Your response will be: 
.Name 
where .Name is the SOS device name for the printer driver file 
that is used to communicate with your Printer (e.g., .Printer). 
B.5 Freezing the Screen Display 
Type <Ctrl>7 to freeze a scrolling screen display (such as a 
listing of all headers), and <Ctrl>7 to resume scrolling. 
B.6 Breaking/Aborting Operations 


To break or abort a screen display or other Messenger opera- 
tion, type <Ctrl>C. 
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Appendix C 


Using the Messenger Program 
in the IBM PC UCSD p-System Environment 


C.0 Introduction 


This Appendix includes instructions and information specific to 
the IBM Personal Computer UCSD p-system environment. It is 
meant to be read in conjunction with Chapters 1-7 of this 
manual. It includes the following information and instructions. 


(1) 


(2) 


(3) 


(4) 


(5) 


(6) 


Invoking the mail program (to be read in conjunction with 
Chapter 2). 


Invoking the mail program automatically upon start up of 
your workstation (to be read in conjunction with Chapter 
2). 


Proper syntax of file names when storing and using text 
files in conjunction with the mail program (to be read in 
conjunction with Chapters 5 and 6). 


Printing messages on a local printer (to be read in con- 
junction with Section 5.9). 


Freezing the screen display. 


Breaking/Aborting Operations 


C.1 Invoking the Mail Program 


The mail program resides on 


/MAIN/LIB/IBMPC/UCSD/PASCAL 


which is the shared library volume for this environment. 
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To invoke the mail program, select the execute function from the 
main p-system command line by typing "X". Then supply the fol- 
lowing specifier: 


LIB:MAIL 


Note: If all virtual drives have mounts on them when the 
Messenger is executed, the program will prompt for available 
drives needed by the program. Provide the program with the 
letter(s) of drives that can be unmounted by the program. The 
current volumes on these drives will not be replaced when you 
leave the mail program. 


If you give the letters of real drives, the mail program will con- 
vert the drives to virtual, returning them to real when you leave 
the program. Do not specify your work volume drive or shared 
library drive for use by the Messenger. 


C.2 Invoking the Mail Program Automaticaily upon 
Startup of Your Workstation 


The network software includes special auto-start features which 
can cause your mail program to be invoked automatically when 
your system is powered up. In order to make use of this capabil- 
ity, you will need to add instructions to your STARTCMD.TEXT 
file which is located on your work volume. Including the word 
"MAIL" as a command line in Startcmd.text will cause the mail 
system to run automatically when the station is booted. 


To learn how to configure this STARTCMD.TEXT file you will 
need to refer to the PLAN Server User's Guide for the IBM Per- 
sonal Computer UCSD p-System Environment. 


When the Messenger is executed, its first action is to read the 
file DEFAULTS.TEXT, if it exists on the boot volume. Any com- 
mand lines in this textfile that begin with the word “MAIL:" are 
executed automatically. Section 3.2 explains what mail com- 
mands can be in DEFAULTS.TEXT. In the commands “Set 
DriveA x" and "Set DriveB y", the x and y should be Pascal 
drive numbers such as 9 or 10. 
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Your system manager may have already configured your 
STARTCMD.TEXT file to include start up of the mail program. If 
you don't like this, it can be changed. Speak with the system 
manager about it. 


C.3 Proper Syntax for File Names when Storing 
and Using Text Files from Messenger 


In Chapters 5 and 6 we tell you how to file messages and how 
to use text files as messages. There are some rules about 
specifying file names in Messenger under the IBM PC UCSD p- 
System environment which are important for you to know. 


When you use the "Write" command or menu option, you are 
asked for a file name. When you read in the text of a message 
from a file, you will need to specify a file name. 


When you are specifying these file names there are some con- 
ventions you should keep in mind. 


If you ask for a text file to be created or found and you supply a 
name without the .text extension, that extension will be 
appended. 


If you ask for a file to be created or found and you supply a 
name which has a .text extension, the file created or found will 
have the exact file name that you typed including the .text 
extension. 


If you ask for a file to be created or found and you end the file 
name with a period, the file that is created or found will not (can 
not) have a .text extension. 


Examples of instances involving these conventions are as fol- 
lows: 


(1) If you ask for “mymail” to be created a file called 
“mymail.text” will be created. 
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(2) If you ask that a file called "Letter.text” be used as a mes- 
sage (after the % character). The file "Letter.text" will be 
used. 


(3) If you ask that a file called “#5:appointments.” be used as 
a message, the file called “#5:appointments” will be used. 
In this case, if there is a file called “appointments.text" on 
the volume on #5:, that file will not be used because the 
existence of the period in your specification tells the sys- 
tem not to automatically append .text to your specification, 
but to look instead for a file name that exactly matches 
your specification. 


(4) If you create a file and supply the name “goals.” the file 
will be created and will be called “goals” not “goals.text". 


NOTE: In the above examples we have sometimes specified 
the volume and sometimes not. You should know that if you 
want to retrieve or create a file, you will need to specify the 
volume name or number only if the volume you are specifying is 
not your prefix volume. 


C.4 Printing Messages on a Local Printer 
If you intend to use a local printer for printing mail messages, 
you must have the appropriate interface card for your printer 


installed in your IBM Personal Computer. 


Having invoked the MAIL program, you can then invoke the 
"Write" function from any of the three levels. 


(1) You can type "WRITE" after the Command? prompt. 


(2) You can select the “Write option from the Incoming Com- 
mand option line by typing "W". 


(3) You can select the Write” option from the Outgoing Com- 
mand option line by typing "W". 


IBM PC p-System 


When you select this option you will be asked the following: 
To what file? 

Your response will be: 
Printer: 

or 


#6: 


C.5 Freezing the Screen Display 

Type <Ctrl>S to freeze a scrolling screen display (such as a 
listing of all headers), and <Ctrl>S to resume scrolling. 

C.6 Breaking/Aborting Operations 


To break or abort a screen display or other Messenger opera- 
tion, type <Ctrl>C. 
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Appendix D 


_Using the Messenger Program 
in the IBM PC DOS Environment 


D.0 Introduction 


This Appendix includes instructions and information specific to 
the IBM Personal Computer DOS environment. It is meant to be 
read in conjunction with Chapters 1-7 of this manual. It includes 
the following information and instructions. 


(1) 


(2) 


(3) 


(4) 


(5) 
(6) 


D.1 


Invoking the mail program (to be read in conjunction with 
Chapter 2). 


Invoking the mail program automatically upon start up of 
your workstation (to be read in conjunction with Chapter 
2). 


Proper syntax of file names when storing and using text 
files in conjunction with the mail program (to be read in 
conjunction with Chapters 5 and 6). 


Printing messages on a local printer (to be read in con- 
junction with Section 5.9). 


Freezing the screen display. 


Breaking/Aborting Operations 


invoking the Mail Program 


The mail program resides on 


/MAIN/LIB/IBMPC/DOS 


which is the shared library volume for this environment. 
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To invoke the mail program, type 


MAIL 


D.2 Invoking the Mail Program Automatically upon 
Startup of Your Workstation 


The network software includes special auto-start features that 
can cause your mail program to be invoked automatically when 
your system is powered up. In order to make use of this capabil- 
ity, you will need to: 


(1) Make sure that your profile volume or the AUTOEXC.BAT 
file on your boot volume contains a command line that 
mounts the network library volume containing the mail pro- 
gram. (Profile volumes and startup are discussed in 
Chapter 1 of the network user guide for your environment.) 


(2) Include in your AUTOEXC.BAT file the line 
X:MAIL 


where X is the drive letter upon which your library volume 
is mounted (usually L:). The mail program will then be 
chained to and run automatically at startup. 


When the Messenger is executed, its first action is to read the 
file DEFAULTS, if it exists on your current default volume. 


To use the defaults on a different volume, mount the volume on 
a drive and change the default to that drive in AUTOEXC.BAT, 
before chaining to the mail program. For example, if the volume 
is to be mounted on drive E, 


NETMOUNT //USERS/EXAMPLE,E: 
E: 
L:MAIL 


Any command lines in the DEFAULTS textfile that begin with 
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the word “MAIL:” will be executed automatically. Section 3.2 
explains what mail commands can be in DEFAULTS. In the 
commands “Set DriveA x” and “Set DriveB y”, the x and y 
should be DOS drive letters such as M or N. Do not use your 
boot drive or the drive containing your library volume. 

Your system manager may have already configured your 
STARTCMD file to include start up of the mail program. If you 
don't like this, it can be changed. Speak with the system 
manager about it. 


D.3 Printing Messages on a Local Printer 
if you intend to use a local printer for printing mail messages, 
you must have the appropriate interface card for your printer 


installed in your IBM Personal Computer. 


Having invoked the MAIL program, you can then invoke the 
“Write” function from any of the three levels. 


(1) You can type “WRITE” after the Command? prompt. 


(2) You can select the “Write” option from the Incoming Com- 
mand option line by typing “W”. 


(3) You can select the “Write” option from the Outgoing Com- 
mand option line by typing “W”. 


When you select this option you will to asked the following: 
To what file? 

Your response will be: 
PRN 

or 
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D.4 Freezing the Screen Display 

Type <Ctrl>S to freeze a scrolling screen display (such as a 

listing of all headers), and <Ctri>S to resume scrolling. po 
D.S Breaking/Aborting Operations 


To break or abort a screen display or other Messenger opera- 
tion, type <Esc>. 
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using text files 3-12 


IN-7 


INDEX 


version, Messenger software v 


W 


“Who are you?” 2-2 
WRITE 5-9, 5-10 
Write) 3-2, 3-4, 3-10, 3-11 


Other 


%filename 3-12 

“2" command 2-8, 6-2 
“&” 4-5 
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Reader Comment Form 


This manual is one in a series that describes the use of 
the PLAN Series systems. 


You are encouraged to use this form to communicate to 
Nestar any problems or suggestions associated with the 
system. We would like your comments on improving the 
system itself, as well as on this documentation. 

Possible topics for comment are: clarity, accuracy, 
completeness, organization, coding, retrieval, and 
legibility. 


No postage stamp is necessary if mailed within the 
U.S.A. 

Nestar installation location: 

Submitter’s name: 


Address: 


Description of problem or suggestion: 


Please mail this form to: Nestar Systems, Incorporated 
2585 E. Bayshore Road 
Palo Alto, California 94303 
Attn: PUBLICATIONS DEPT. 
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